Release 10.1A: OpenEdge Development:
ADM Reference

blankWidget

Blanks the SCREEN-VALUE of the objects in the namelist. The DataValue is blanked for a SmartDataField (this would always be the key field for a lookup even where the display field is different).

Location: visual.p

Parameters:

INPUT namelist AS CHARACTER

The name of one or more objects, separated by commas.

Returns: LOGICAL

Notes:

This function sets the DataModified attribute to force the toolbar to enable saving data (it behaves as if the user actually changed the field value manually).
This function does nothing to objects that do not support SCREEN-VALUE and to objects where a blank screen value does not make sense, such as toggle boxes. It blanks a combo-box by setting its list items to its list items.
Examples:

The following illustrates the use of this method in 4GL code for use with a graphical user interface:

IF widgetIsTrue("customerviewv.disableAccount":U) THEN blankWidget("Self.accountID":U).

The following illustrates the use of this method in DHTML code for use with a Web browser:

if (logic.widgetIsTrue(‘customerviewv.disableAccount’)) logic.blankWidget(‘myviewv.accountID’);